Generate a Key

Command:

To generate a key and optionally encrypt key under ZMK for transmission.

Notes:

See Key Type Table to find key type code.

See Key Scheme Table for schemes available to encrypt keys.

Authorised state is enforced as per Key Type Table.

Field

Length & Type

Details

COMMAND MESSAGE

Message header

m A

(Subsequently returned to the Host unchanged).

Command code

2 A

Value A0.

Mode

1 H

0 – Generate Key.

1 – Generate key and encrypt under ZMK.

Key type

3 H

Key type.

Key Scheme (LMK)

1 A

Key length / scheme for encrypting key under LMK. See section “Key Scheme Table”.

ZMK

16H or 32H or
1A+32H or 1A+48H

ZMK only present if mode = 1.

Key scheme (ZMK)

1 A

Key scheme for encrypting key for export.  Only present if mode = 1.

Atalla Variant

1 N or 2 N

Optional. Atalla variant; for use in systems with Atalla equipment.  Only present if mode = 1.

End message delimiter

1 C

Optional. Must be present if a message trailer is present. Value X’19.

Message trailer

n A

Optional. Maximum length 32 characters.

RESPONSE MESSAGE

Message header

n A

Returned to the Host unchanged.

Response code 

2 A

Value A1.

Error code

2 N

00 : No errors

10 : ZMK Parity error

12 : No keys loaded in user storage

13 : LMK error : report to supervisor

15 : Error in input data

21 : Invalid user storage index

Key (LMK)

16H or
1A+32H or 1A+48H

The key encrypted under LMK.

Key (ZMK)

16H or
1A+32H or 1A+48H

The key encrypted under ZMK only present if mode =1.

Key check value

6 H

The key check value.

End message delimiter

1 C

Present only if present in the command message. Value X’19.

Message trailer

n A

Present only if present in the command message. Maximum length 32 characters.